home *** CD-ROM | disk | FTP | other *** search
/ 130 MIDI Tool Box / 130 MIDI Tool Box.iso / ravelutl / mtor.man < prev    next >
Text File  |  1990-01-27  |  6KB  |  178 lines
  1.         mtor                            RAVEL                             mtor
  2.  
  3.         NNAAMMEE
  4.  
  5.         mtor - Ravel midi file format to Ravel translator
  6.  
  7.         SSYYNNOOPPSSIISS
  8.  
  9.         mmttoorr [-b][-t][-s scale] [-p poff] <filename>
  10.  
  11.         DDEESSCCRRIIPPTTIIOONN
  12.  
  13.         mmttoorr is a program that translates from Midi Files Format to a
  14.         subset of the Ravel music programming language.
  15.  
  16.              mmttoorr is a new Ravel utility and may be said to be in
  17.         beta-test at this point in time. There should be a matching rrttoomm
  18.         utility to translate the other way, but there currently is not.
  19.         There may be bugs large and small. Please report any
  20.         difficulties.
  21.  
  22.              Mtor is based on a midi file format package supplied by Tim
  23.         Thompson and may be considered public domain in entirety. Mtor
  24.         is supplied as a free part of the Ravel package. (This won't do
  25.         anybody much good, but so it goes). Credit is due to Tim
  26.         Thompson for making his midi file library available. Any defects
  27.         found herein are not Tim Thompson's responsiblity.
  28.  
  29.              mmttoorr takes an input file that is a midi files format and
  30.         reads the binary file translating into some number of "vco"
  31.         structures, one per track. The output is ASCII and is written to
  32.         stdout. It may be redirected to a file using a shell redirect
  33.         '>'; e.g.,
  34.  
  35.         dos> mtor input.mid > output.ma
  36.  
  37.         The resulting ".ma" file may be translated by "mc" and played
  38.         with "mos". Since it is an ASCII file, it can be edited with an
  39.         normal editor.
  40.  
  41.              mmttoorr only handles the following Ravel actions at this
  42.         point: sig, rest, note (duration), key, tie, patch, ccont, kat,
  43.         cat, metro, bend, vco...end. This is to say that anything else
  44.         found in a midi file format that does not fit into the above
  45.         Ravel pigeonholes will not be translated. In many cases Ravel
  46.         comments about untranslatable entities are produced. In general,
  47.         multiple midi tracks are translated into multiple vco streams.
  48.         This is done so that the file can be translated immediately and
  49.         played under mos. However such vco streams can always be
  50.         slightly recoded into suitable action data structures if
  51.         desired.
  52.  
  53.              Note that switches are optional. This is denoted by placing
  54.         [] characters around the switch. The switch notation is "-",
  55.  
  56.  
  57.  
  58.      January 28, 1990                                                page 1
  59.  
  60.         which is the Unix convention. Msdos switches will not work. The
  61.         program is looking for "-".
  62.  
  63.              The [[--ss ssccaallee]] scale switch is used for scaling down event
  64.         times; i.e., events per quarter note. The default scale is 1. If
  65.         a larger value is set, that value is used to divide all internal
  66.         beats per quarter note values. If the scale switch is not set,
  67.         and the midi header division value is evenly divisible by 24,
  68.         the internal scale will be overridden by the division; i.e.,
  69.         things will adjust correctly by themselves. This is what
  70.         normally should happen. Conversely if the scale switch is set,
  71.         any internal midi division value will be overridden. Note that
  72.         Ravel treats a quarter note as 24 events. When translating from
  73.         Cakewalk, which has 120 events per quarter note, one might
  74.         choose to set -s to 5 to scale 120 events to 24 events. This
  75.         would have some unwanted quantization, although an attempt is
  76.         made to issue rests occasionally when an internal slop counter
  77.         overflows. The scale switch may always be used to specify a
  78.         different non-zero scaling factor. A scaling factor of 1 would
  79.         preserve the Cakewalk units, but of course the piece would run
  80.         slower at the same meter.  If scaling is set, all event times
  81.         (elapsed events and durations) are scaled.
  82.  
  83.              The [[--pp ppooffff]] switch is optional and will set the pitch
  84.         bend offset to whatever non-zero value is given. The pitch bend
  85.         offset defaults to 64 if not set. The pitch bend range in MIDI
  86.         is a 14 bit unsigned number; in decimal this is 0 to 16383. A
  87.         centered wheel has the value 8192. Ravel uses a "pseudo-op"
  88.         called the "poff" or pitch bend offset that is multiplied
  89.         internally against the value used with the pitch bend action;
  90.         e.g.,
  91.  
  92.         bend q 128
  93.  
  94.         is the value for a centered wheel, since 128 * 64 = 8192. Note
  95.         that a pitch offset of 1 will leave the units unscaled. This may
  96.         be a useful thing to do when translating from CAKEWALK to Ravel,
  97.         since loss of precision may result from division.
  98.  
  99.              Time constants are not translated unless the [[--tt]] switch is
  100.         given. Time constants are translated if and only if there is a
  101.         suitable Ravel constant; otherwise they are left in decimal.
  102.  
  103.              If the [[--bb]] switch is given, pitch bend information is
  104.         removed from the streams. If a pitch bend has a non-zero event
  105.         time, this is translated into a tie. This is useful for removing
  106.         extraneous pitch bends that might be produced by a guitar
  107.         controller.
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.      January 28, 1990                                                page 2
  118.  
  119.         SSEEEE AALLSSOO
  120.  
  121.         rtoc, mc, mos.
  122.  
  123.         BBUUGGSS
  124.  
  125.         mtor is a new utility and has not been tested much at this
  126.         point. There are undoubtedly some flaws.
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.      January 28, 1990                                                page 3
  177.  
  178.